home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / X11 / XChangeWindowAttributes.z / XChangeWindowAttributes
Encoding:
Text File  |  2002-10-03  |  13.8 KB  |  265 lines
  1.  
  2.  
  3.  
  4.      XXXXCCCChhhhaaaannnnggggeeeeWWWWiiiinnnnddddoooowwwwAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXCCCChhhhaaaannnnggggeeeeWWWWiiiinnnnddddoooowwwwAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XChangeWindowAttributes, XSetWindowBackground,
  10.           XSetWindowBackgroundPixmap, XSetWindowBorder,
  11.           XSetWindowBorderPixmap, XSetWindowColormap - change window
  12.           attributes
  13.  
  14.      SSSSYYYYNNNNTTTTAAAAXXXX
  15.           XChangeWindowAttributes(_d_i_s_p_l_a_y, _w, _v_a_l_u_e_m_a_s_k, _a_t_t_r_i_b_u_t_e_s)
  16.                 Display *_d_i_s_p_l_a_y;
  17.                 Window _w;
  18.                 unsigned long _v_a_l_u_e_m_a_s_k;
  19.                 XSetWindowAttributes *_a_t_t_r_i_b_u_t_e_s;
  20.  
  21.           XSetWindowBackground(_d_i_s_p_l_a_y, _w, _b_a_c_k_g_r_o_u_n_d__p_i_x_e_l)
  22.                 Display *_d_i_s_p_l_a_y;
  23.                 Window _w;
  24.                 unsigned long _b_a_c_k_g_r_o_u_n_d__p_i_x_e_l;
  25.  
  26.           XSetWindowBackgroundPixmap(_d_i_s_p_l_a_y, _w, _b_a_c_k_g_r_o_u_n_d__p_i_x_m_a_p)
  27.                 Display *_d_i_s_p_l_a_y;
  28.                 Window _w;
  29.                 Pixmap _b_a_c_k_g_r_o_u_n_d__p_i_x_m_a_p;
  30.  
  31.           XSetWindowBorder(_d_i_s_p_l_a_y, _w, _b_o_r_d_e_r__p_i_x_e_l)
  32.                 Display *_d_i_s_p_l_a_y;
  33.                 Window _w;
  34.                 unsigned long _b_o_r_d_e_r__p_i_x_e_l;
  35.  
  36.           XSetWindowBorderPixmap(_d_i_s_p_l_a_y, _w, _b_o_r_d_e_r__p_i_x_m_a_p)
  37.                 Display *_d_i_s_p_l_a_y;
  38.                 Window _w;
  39.                 Pixmap _b_o_r_d_e_r__p_i_x_m_a_p;
  40.  
  41.           XSetWindowColormap(_d_i_s_p_l_a_y, _w, _c_o_l_o_r_m_a_p)
  42.                 Display *_d_i_s_p_l_a_y;
  43.                 Window _w;
  44.                 Colormap _c_o_l_o_r_m_a_p;
  45.  
  46.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  47.           _a_t_t_r_i_b_u_t_e_s
  48.                     Specifies the structure from which the values (as
  49.                     specified by the value mask) are to be taken.  The
  50.                     value mask should have the appropriate bits set to
  51.                     indicate which attributes have been set in the
  52.                     structure.
  53.  
  54.           _b_a_c_k_g_r_o_u_n_d__p_i_x_e_l
  55.                     Specifies the pixel that is to be used for the
  56.                     background.
  57.  
  58.           _b_a_c_k_g_r_o_u_n_d__p_i_x_m_a_p
  59.                     Specifies the background pixmap, _P_a_r_e_n_t_R_e_l_a_t_i_v_e,
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXCCCChhhhaaaannnnggggeeeeWWWWiiiinnnnddddoooowwwwAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXCCCChhhhaaaannnnggggeeeeWWWWiiiinnnnddddoooowwwwAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))
  71.  
  72.  
  73.  
  74.                     or _N_o_n_e.
  75.  
  76.           _b_o_r_d_e_r__p_i_x_e_l
  77.                     Specifies the entry in the colormap.
  78.  
  79.           _b_o_r_d_e_r__p_i_x_m_a_p
  80.                     Specifies the border pixmap or _C_o_p_y_F_r_o_m_P_a_r_e_n_t.
  81.  
  82.           _d_i_s_p_l_a_y   Specifies the connection to the X server.
  83.  
  84.           _v_a_l_u_e_m_a_s_k Specifies which window attributes are defined in
  85.                     the attributes argument.  This mask is the bitwise
  86.                     inclusive OR of the valid attribute mask bits.  If
  87.                     valuemask is zero, the attributes are ignored and
  88.                     are not referenced.
  89.  
  90.           _w         Specifies the window.
  91.  
  92.           _c_o_l_o_r_m_a_p  Specifies the colormap.
  93.  
  94.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  95.           Depending on the valuemask, the _X_C_h_a_n_g_e_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s
  96.           function uses the window attributes in the
  97.           _X_S_e_t_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s structure to change the specified
  98.           window attributes.  Changing the background does not cause
  99.           the window contents to be changed.  To repaint the window
  100.           and its background, use _X_C_l_e_a_r_W_i_n_d_o_w.  Setting the border or
  101.           changing the background such that the border tile origin
  102.           changes causes the border to be repainted.  Changing the
  103.           background of a root window to _N_o_n_e or _P_a_r_e_n_t_R_e_l_a_t_i_v_e
  104.           restores the default background pixmap.  Changing the border
  105.           of a root window to _C_o_p_y_F_r_o_m_P_a_r_e_n_t restores the default
  106.           border pixmap.  Changing the win-gravity does not affect the
  107.           current position of the window.  Changing the backing-store
  108.           of an obscured window to _W_h_e_n_M_a_p_p_e_d or _A_l_w_a_y_s, or changing
  109.           the backing-planes, backing-pixel, or save-under of a mapped
  110.           window may have no immediate effect.  Changing the colormap
  111.           of a window (that is, defining a new map, not changing the
  112.           contents of the existing map) generates a _C_o_l_o_r_m_a_p_N_o_t_i_f_y
  113.           event.  Changing the colormap of a visible window may have
  114.           no immediate effect on the screen because the map may not be
  115.           installed (see _X_I_n_s_t_a_l_l_C_o_l_o_r_m_a_p).  Changing the cursor of a
  116.           root window to _N_o_n_e restores the default cursor.  Whenever
  117.           possible, you are encouraged to share colormaps.
  118.  
  119.           Multiple clients can select input on the same window. Their
  120.           event masks are maintained separately.  When an event is
  121.           generated, it is reported to all interested clients.
  122.           However, only one client at a time can select for
  123.           _S_u_b_s_t_r_u_c_t_u_r_e_R_e_d_i_r_e_c_t_M_a_s_k, _R_e_s_i_z_e_R_e_d_i_r_e_c_t_M_a_s_k, and
  124.           _B_u_t_t_o_n_P_r_e_s_s_M_a_s_k.  If a client attempts to select any of
  125.           these event masks and some other client has already selected
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXCCCChhhhaaaannnnggggeeeeWWWWiiiinnnnddddoooowwwwAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXCCCChhhhaaaannnnggggeeeeWWWWiiiinnnnddddoooowwwwAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))
  137.  
  138.  
  139.  
  140.           one, a _B_a_d_A_c_c_e_s_s error results.  There is only one do-not-
  141.           propagate-mask for a window, not one per client.
  142.  
  143.           _X_C_h_a_n_g_e_W_i_n_d_o_w_A_t_t_r_i_b_u_t_e_s can generate _B_a_d_A_c_c_e_s_s, _B_a_d_C_o_l_o_r,
  144.           _B_a_d_C_u_r_s_o_r, _B_a_d_M_a_t_c_h, _B_a_d_P_i_x_m_a_p, _B_a_d_V_a_l_u_e, and _B_a_d_W_i_n_d_o_w
  145.           errors.
  146.  
  147.           The _X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d function sets the background of the
  148.           window to the specified pixel value.  Changing the
  149.           background does not cause the window contents to be changed.
  150.           _X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d uses a pixmap of undefined size filled
  151.           with the pixel value you passed.  If you try to change the
  152.           background of an _I_n_p_u_t_O_n_l_y window, a _B_a_d_M_a_t_c_h error results.
  153.  
  154.           _X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d can generate _B_a_d_M_a_t_c_h and _B_a_d_W_i_n_d_o_w
  155.           errors.
  156.  
  157.           The _X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d_P_i_x_m_a_p function sets the background
  158.           pixmap of the window to the specified pixmap.  The
  159.           background pixmap can immediately be freed if no further
  160.           explicit references to it are to be made.  If _P_a_r_e_n_t_R_e_l_a_t_i_v_e
  161.           is specified, the background pixmap of the window's parent
  162.           is used, or on the root window, the default background is
  163.           restored.  If you try to change the background of an
  164.           _I_n_p_u_t_O_n_l_y window, a _B_a_d_M_a_t_c_h error results.  If the
  165.           background is set to _N_o_n_e, the window has no defined
  166.           background.
  167.  
  168.           _X_S_e_t_W_i_n_d_o_w_B_a_c_k_g_r_o_u_n_d_P_i_x_m_a_p can generate _B_a_d_M_a_t_c_h, _B_a_d_P_i_x_m_a_p,
  169.           and _B_a_d_W_i_n_d_o_w errors.
  170.  
  171.           The _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r function sets the border of the window
  172.           to the pixel value you specify.  If you attempt to perform
  173.           this on an _I_n_p_u_t_O_n_l_y window, a _B_a_d_M_a_t_c_h error results.
  174.  
  175.           _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r can generate _B_a_d_M_a_t_c_h and _B_a_d_W_i_n_d_o_w errors.
  176.  
  177.           The _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r_P_i_x_m_a_p function sets the border pixmap
  178.           of the window to the pixmap you specify.  The border pixmap
  179.           can be freed immediately if no further explicit references
  180.           to it are to be made.  If you specify _C_o_p_y_F_r_o_m_P_a_r_e_n_t, a copy
  181.           of the parent window's border pixmap is used.  If you
  182.           attempt to perform this on an _I_n_p_u_t_O_n_l_y window, a _B_a_d_M_a_t_c_h
  183.           error results.
  184.  
  185.           _X_S_e_t_W_i_n_d_o_w_B_o_r_d_e_r_P_i_x_m_a_p can generate _B_a_d_M_a_t_c_h, _B_a_d_P_i_x_m_a_p, and
  186.           _B_a_d_W_i_n_d_o_w errors.
  187.  
  188.           The _X_S_e_t_W_i_n_d_o_w_C_o_l_o_r_m_a_p function sets the specified colormap
  189.           of the specified window.  The colormap must have the same
  190.           visual type as the window, or a _B_a_d_M_a_t_c_h error results.
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      XXXXCCCChhhhaaaannnnggggeeeeWWWWiiiinnnnddddoooowwwwAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXCCCChhhhaaaannnnggggeeeeWWWWiiiinnnnddddoooowwwwAAAAttttttttrrrriiiibbbbuuuutttteeeessss((((3333XXXX11111111))))
  203.  
  204.  
  205.  
  206.           _X_S_e_t_W_i_n_d_o_w_C_o_l_o_r_m_a_p can generate _B_a_d_C_o_l_o_r, _B_a_d_M_a_t_c_h, and
  207.           _B_a_d_W_i_n_d_o_w errors.
  208.  
  209.      DDDDIIIIAAAAGGGGNNNNOOOOSSSSTTTTIIIICCCCSSSS
  210.           _B_a_d_A_c_c_e_s_s A client attempted to free a color map entry that
  211.                     it did not already allocate.
  212.  
  213.           _B_a_d_A_c_c_e_s_s A client attempted to store into a read-only color
  214.                     map entry.
  215.  
  216.           _B_a_d_C_o_l_o_r  A value for a Colormap argument does not name a
  217.                     defined Colormap.
  218.  
  219.           _B_a_d_C_u_r_s_o_r A value for a Cursor argument does not name a
  220.                     defined Cursor.
  221.  
  222.           _B_a_d_M_a_t_c_h  Some argument or pair of arguments has the correct
  223.                     type and range but fails to match in some other
  224.                     way required by the request.
  225.  
  226.           _B_a_d_M_a_t_c_h  An _I_n_p_u_t_O_n_l_y window locks this attribute.
  227.  
  228.           _B_a_d_P_i_x_m_a_p A value for a Pixmap argument does not name a
  229.                     defined Pixmap.
  230.  
  231.           _B_a_d_V_a_l_u_e  Some numeric value falls outside the range of
  232.                     values accepted by the request.  Unless a specific
  233.                     range is specified for an argument, the full range
  234.                     defined by the argument's type is accepted.  Any
  235.                     argument defined as a set of alternatives can
  236.                     generate this error.
  237.  
  238.           _B_a_d_W_i_n_d_o_w A value for a Window argument does not name a
  239.                     defined Window.
  240.  
  241.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  242.           XConfigureWindow(3X11), XCreateWindow(3X11),
  243.           XDestroyWindow(3X11), XInstallColormap(3X11),
  244.           XMapWindow(3X11), XRaiseWindow(3X11), XUnmapWindow(3X11)
  245.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 10/3/02)
  262.  
  263.  
  264.  
  265.